home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu478.dms / pu478.adf / ARESTAURE / ARestaure.ENGLISH < prev    next >
Encoding:
Text File  |  1993-09-02  |  8.9 KB  |  282 lines
  1.  
  2.      //                 ARestaure v2.01 - Documentation            //
  3.    \X/                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~          \X/
  4.  
  5.     
  6.     This  manual  describes the  version 2.01 of  ARestaure.  This
  7. tools is ©1992  by  Jehan-Yves  PROUX,  the  commercial use is STRICLY
  8. FORBIDDEN without author written agreement.
  9.  
  10.     This program can  be  freely distributed, you can spread it in
  11. the way you want,  but  the  program  MUST  be  distributed  WITH  its
  12. documentation  in all  languages  (for  instance  French,  German  and
  13. English) without ANY modification.
  14.  
  15.     I made a lot of tests, but I declines any responsability about
  16. the use of ARestaure. YOU ARE USING  THIS TOOLS AT YOUR OWN RISK.  The
  17. author is not responsible of any  damage, as result of  the use of his
  18. program.
  19.  
  20.     This  program is ShareWare.  It means that  if  you  like  it,
  21. you're invited to send  a donation of 50FF at the address shown at the
  22. end  of this file. You will become a  registrated user. You can pay by
  23. these ways:
  24.     - cheque of a european bank (for french francs),
  25.     - ready cash (european money or dollar).
  26.  
  27.  
  28.  
  29. Contents
  30. ~~~~~~~~
  31.  
  32.     1. Introduction
  33.     2. How does it works?
  34.     3. Usage
  35.        3.1 Restoration Mode
  36.        3.2 Cleaning Mode
  37.     4. Languages supported
  38.     5. Additional Notes
  39.     6. Thanks
  40.     7. Historic
  41.     8. Conclusion
  42.  
  43.  
  44.  
  45. 1. Introduction
  46. ~~~~~~~~~~~~~~~
  47.  
  48.     Have  you  ever  delete  accidentally a file  or see  after  a
  49. "delete #?" that you were not in the rigth directory ?
  50.  
  51.     Yes? I  too... It's why I have written this utility ARestaure,
  52. which as it name says (with french spelling), permits  you to  restore
  53. files that you have destroyed...
  54.  
  55.  
  56. 2. How does it works?
  57. ~~~~~~~~~~~~~~~~~~~~~
  58.  
  59.     When you delete a file two main actions occurs on your current
  60. volume:
  61.         - your file is disconnected from the directory tree of
  62.             your volume.
  63.  
  64.         - sectors that  your file  owned, are declared free in
  65.             the  BitMap  block(s)  of your  volume.  These
  66.             sectors are never zeroed during this operation
  67.             : the datas are still on your disk.
  68.  
  69.     ARestaure  will  scan your volume, searching for deleted files
  70. and permit you to undelete them.
  71.  
  72.  
  73. 3. Usage
  74. ~~~~~~~~
  75.  
  76.     To start ARestaure, click on its icon on the Workbench or type
  77. "ARestaure" under the Shell.
  78.  
  79.     ARestaure will start to search in your system all the  volumes
  80. that it can manage,  and it will  show you only these  ones  : Also if
  81. you have  a Mac, Unix, Atari, C=64, Sinclair QL,  Apple-II, or why not
  82. an MS-DOS partition, you won't see it on your screen.
  83.     In fact, ARestaure know only how to manage Amiga partitions or
  84. volumes: OFS (the Old Filing System) and FFS (the Fast Filing System),
  85. that  it  means about  98%  of  disks  connected with  our  well-known
  86. machine.
  87.  
  88.     You  will notice  that ARestaure cannot restore a file deleted
  89. on RAM:, this volume  is purely memory, and space used by your file is
  90. freed when your file  is deleted, it's why RAM: is not  shown on  your
  91. screen. But ARestaure can restore files lost in RAD:.
  92.  
  93.     You have on your screen the following buttons:
  94.  
  95.     DF0: .. DF3:    one button per drive connected (empty or not)
  96.     DH0: .. DHx:
  97.     ..    ..
  98.     ..    ..
  99.     ..    ..
  100.     ..    ..    and as many buttons as you have drives
  101.  
  102.     Français
  103.     Deutsch        to change the current language
  104.     English
  105.  
  106.     SaveCfg        to save the chosen language
  107.  
  108.     Quit        to quit ARestaure.
  109.  
  110.  
  111.     3.1 Restoration Mode
  112.     ~~~~~~~~~~~~~~~~~~~~
  113.  
  114.         It is the default mode of ARestaure, you can see it by
  115.     viewing the "Mode" Menu.
  116.         In  this  mode,  if you  select a drive,  the  program
  117.     will begin the search immediatly on this drive. A flashing LED
  118.     on  the drive  button indicates  that the program continue  to
  119.     search.
  120.  
  121.         If ARestaure  cannot find any  files, it  will  signal
  122.     it to you in the message box;  if it can,  it will open a file
  123.     requester where you can select the files you want to restaure,
  124.     then  type  <Cancel> or <Restore>.   After that  you  will  be
  125.     back in the starting menu to select another drive or to quit.
  126.  
  127.         Where to find your files? It is impossible to  restore
  128.     your  files  in  the  places  they  were before  the  deletion
  129.     because it is impossible to find where they were linked in the
  130.     directory tree of your volume.  Also I had decided to  restore
  131.     them in T:, the temporary directory of  the Amiga. Usually, T:
  132.     is assigned  to RAM: (see  your Startup-Sequence).  After  the
  133.     restoration, you only have to move the restored files from  T:
  134.     to where you want.
  135.  
  136.         NOTA:    You should have to  enough room in  T: for the
  137.     files you want to restore.
  138.  
  139.         NOTA:    If  several  files  with  the same name are to
  140.     restore, ARestaure will add a count at the end of the filename
  141.     (like ".03").
  142.  
  143.  
  144.     3.2 Cleaning Mode
  145.     ~~~~~~~~~~~~~~~~~
  146.  
  147.         After some  uses of ARestaure in Restoration Mode, you
  148.     will see that ARestaure shows you  a lot of files which aren't
  149.     interessant for you. The goal of  the Cleaning is to zero  all
  150.     free sectors, this forbid  to see  the files destroyed  before
  151.     this operation. This Cleaning has two advantages:
  152.         - You will see only  files removed  after the cleaning
  153.             operation.
  154.         - If you give a disk to someone, you  are sure to give
  155.             only the files you want (and not removed files
  156.             that the person can restore using ARestaure).
  157.  
  158.         To  use  this  mode,  select "Cleaning"  in the "Mode"
  159.     menu. Then select  the  drive you  want. After  a confirmation
  160.     requester, the work begins.
  161.  
  162.         NOTA:    The  drive  must  be   not  protected  against
  163.     writing !
  164.  
  165.  
  166. 4. Languages Supported
  167. ~~~~~~~~~~~~~~~~~~~~~~
  168.  
  169.     ARestaure is  now  almost  ready for the  Amiga Workbench 2.1,
  170. which will support up to  8 languages (according to C=Amiga austria in
  171. Amiga Magazin [german magazine] on 9/92): ARestaure supports the three
  172. languages  I  understand:  French  (my  native  langage),  german  and
  173. english.
  174.  
  175.  
  176.     You  can select the language you want on the main screen. But,
  177. it's impossible to change the current language, when you have the file
  178. requester opened  :  I  didn't  want to manage this, I suppose in fact
  179. that  a normal user  needn't  to change  the current language  all the
  180. time.
  181.  
  182.     I  think that  in the Amiga Workbench  2.1,  there will  be  a
  183. variable like  $LANG,  on Unix  machines,  which  indicates  the  user
  184. language. But with no more information from C=Amiga, I offer you these
  185. three language buttons.
  186.  
  187.     To  finish with languages, if you  want to  get  a translation
  188. for  the docs  of your software  (that  YOU  have  created  for Public
  189. Domain only), from german or english to french, please write to me.
  190.  
  191.     P.S:    I'm searching  for someone who can correct  my  german
  192. docs, which certainly contains some mistakes.
  193.     
  194.  
  195. 5. Additional Notes
  196. ~~~~~~~~~~~~~~~~~~~
  197.  
  198.     If  you  look at  the  percentage  of  scanned  disk  (between
  199. Languages buttons and the  SaveCfg  button),  you  will see  that  the
  200. scanning  speed varies:  this is  due to the  fact that ARestaure only
  201. read  (or  write)  free  sectors.  So  it  will scan faster  allocated
  202. sectors.
  203.  
  204.     You  can  stop the search for deleted files or the cleaning by
  205. pressing the <Esc> key.
  206.  
  207.  
  208. 6. Thanks
  209. ~~~~~~~~~
  210.  
  211.     I want to thanks here the following persons and firms:
  212.  
  213.     - Muriel PROUX,  my wife for her patience and help in building
  214.         my user interface.
  215.  
  216.     - Denis GOUNELLE, for his ideas and tests of béta-versions, he
  217.         makes on his machine.
  218.  
  219.     - Henric GOMES, who made me discover the wonderfull Amiga.
  220.  
  221.     - Commodore-Amiga for the machine... What a pity that C= sells
  222.         MS-DOS machines too...
  223.  
  224.     -   Free   Software  Fundation   for   the   best   editor   I
  225.         know: GNUEmacs, I used  GNUEmacs on Unix machine
  226.         during my job and on the Amiga.
  227.  
  228.  
  229.     - David GAY  (Switzerland)  for  his GNUEmacs'  Amiga  port, a
  230.         very good job, David ! Continue to work for the Amiga.
  231.  
  232.  
  233. 7. Historic
  234. ~~~~~~~~~~~
  235.  
  236.     v1.00    13-Oct-92
  237.         o First spread version.
  238.  
  239.     v1.XX    11-Nov-92
  240.         o Preversion  of the  v2.00, restricted  spreading for
  241.           validation.
  242.         o Cleaning Mode added
  243.         o some I/O are better tested
  244.         o evolution of percentage is smoother
  245.         o in  restoration mode, if several file have  the same
  246.           name, ".XX" is added at the end of the filenames.
  247.  
  248.     v2.00    28-Nov-92
  249.         o Date of files are added in FileRequester of  deleted
  250.           files.
  251.         o GadgetBorder are changed.
  252.  
  253.     v2.01    06-Dec-92
  254.         o Now  I  use  RemoveGList() during the  search or the
  255.           cleaning, this permit me to  forbid user to  disturb
  256.           the display.
  257.         o The  user  must now use the Esc key (and no more the
  258.           SELECT mouse key) to  stop the searching or cleaning
  259.           operation,  this  avoid  to  stop   accidentally  an
  260.           operation on a 60Mb harddisk.
  261.  
  262.  
  263. 8. Conclusion
  264. ~~~~~~~~~~~~~
  265.  
  266.     I'm waiting for your suggestions  and beta-tests (there may be
  267. some   problems,   which   escaped   from  source  inspection  !)  and
  268. donation, if I save you long hours of work.
  269.     You can write  me in french, in german or in english [in order
  270. of  my  preferences,  the  French  language  is  my   motherlanguage].
  271. My address is the following:
  272.  
  273.         Jehan-Yves PROUX
  274.         46bis, Bd Robespierre
  275.         F-78300 Poissy
  276.         FRANCE - EUROPE
  277.  
  278. E-Mail:            jyp@ritd.co.uk
  279.  
  280.  
  281.     C U soon !!
  282.